﻿MIDP: WordPress
=======================

This Java ME application demonstrates the use of the QWERTY keyboard and the 
widescreen resolution of the Nokia C3 device. The application is a WordPress 
blogging client. In this kind of an application, reading and entering text is 
important. 

The application has a custom UI to optimise screen usage. It uses the
canvas based text editor API for text input. The application also
contains XML-RPC networking for communicating with WordPress servers. 

-------------------------------------------------------------------------------

PREREQUISITES

Java ME basics

-------------------------------------------------------------------------------

IMPORTANT FILES AND CLASSES

src\..\WordpressMidlet.java
src\..\view\ViewMaster.java
src\..\view\BaseView.java
src\..\view\LoginView.java
src\..\components\DataModel.java
src\..\networking\GetRecentPostsOperation.java

-------------------------------------------------------------------------------

DESIGN CONSIDERATIONS

The application is modeled after the S60 WordPress blog administration client 
and implements only a few of the main functionalities. The objective is to 
demonstrate the usefulness of the QWERTY keyboard.

The custom UI is based on the GameCanvas. This allows optimal screen
usage and some animation effects which are not possible using the
standard UI classes. The drawback of implementing a custom UI is the
complexity compared to the implementation of a standard UI.

The login credentials are saved and reused the next time the application is
started.

The application has been initially designed for QVGA landscape (320x240) 
display but it can also be run on devices with a QVGA portrait display.

-------------------------------------------------------------------------------

KNOWN ISSUES

Only a small set of blogging and administration functionalities is supported. 
WordPress allows some HTML-style formatting in the text content, but the 
formatting is not displayed correctly in the application.

-------------------------------------------------------------------------------

BUILD AND INSTALLATION INSTRUCTIONS

The example has been made with NetBeans 6.7.1 and the Series 40 6th
Edition SDK FP1. The project can be opened in NetBeans by selecting
'Open Project' from the File menu and selecting the application
directory.

Before opening the project, make sure that the Series 40 6th Edition SDK is 
installed and added to NetBeans. Building is done by selecting 'Build main 
project'. 

Installing the application on a device can be done by transfering the JAR file 
via Nokia Ovi Suite or via Bluetooth. 

-------------------------------------------------------------------------------

RUNNING THE EXAMPLE

When the application is run, the user is presented with the login view. After 
a succesful login, blogs, posts, and comments are loaded, and the posts view 
is opened. Switching between the posts and comments is done with the left and 
right keys.

Each view has some functionalities in the options menu and in the soft keys.

In the posts view, the user can:
- view the blog posts
- write a new post
- see comments related to a post
- write a new comment to a post
- delete a comment from a post

In the comments view, the user can:
- view the comments related to all posts, newest ones are displayed first
- view a single comment
- delete a comment

-------------------------------------------------------------------------------

COMPATIBILITY

Series 40 6th Edition FP1

Tested on:
Nokia C3

Developed with:
Netbeans 6.7.1
Series 40 6th edition SDK FP1

-------------------------------------------------------------------------------

CHANGE HISTORY

1.0 	First Release
1.1 	Uses com.nokia.mid.ui.TextEditor for text input

-------------------------------------------------------------------------------

RELATED DOCUMENTATION

Package javax.microedition.lcdui in the Java Developer's Library:
http://library.forum.nokia.com/topic/Java_Developers_Library/GUID-0D0A1092-5037-4421-B466-B958CB777414/javax/microedition/lcdui/package-summary.html

Text Editor:
http://library.forum.nokia.com/index.jsp?topic=/Java_Developers_Library/GUID-698E46D0-2D39-4628-99B6-F0C9586539CE.html
